 <span style="font-size: 120%; font-weight: bold;">QuestionOptions</span>
 
 <div style="font-style: italic; margin-top: 3px;">Different options in the question editing page</div>
 
 </div>
 <p>The following are the explanation of options in the editing page of 
formulas question type. These options are divided by the global options 
that affect the all subquestions answer and the local options for each 
individual answer. </p><p></p><hr><h1><a name="Question_text"></a>Question text<a href="#Question_text" class="section_anchor">¶</a></h1><p>In addition to the main question text, you can also use global variables and placeholder here. </p><p>The
 global variables will be replaced by its value and the placeholders 
will be replaced by an answer box or the subquestion answer format. </p><p>A simple example with variables <tt> A, B, C </tt> and placeholders <tt> #1, #2, #3 </tt> are shown. </p><pre class="prettyprint">What is the result of {A} + {B}?<br>{#1}<br>What is the result of {A} - {B}?<br>{#2}<br>What is the result of {C} / {B}?<br>{#3}</pre><hr><h1><a name="Random_variables"></a>Random variables<a href="#Random_variables" class="section_anchor">¶</a></h1><p>You can assign new random values for variables whenever a question is 
created,  which allows different students receive the same question with
 different values.  You can do that by giving it a set of elements to 
choose from: </p><pre class="prettyprint">A = {1,2,3};<br>B = {"A","B","C"};<br>C = {[1,-1], [2,-2], [3,-3]};<br>D = {["a","z"], ["b","y"], ["c","x"]};<br>E = {10:100:10, 100, 1000};</pre><p>During the start of a quiz, one element will be drawn from the set and assign 
to the variable on the left.  The four element type that you can use are
 number (e.g. A), string (e.g. B), list of number (e.g. C) and list of 
string (e.g. D).  Also, for the set of number, you can use the range 
notation like 10:100:10 (e.g. E). </p><h1><a name="Global_variables"></a>Global variables<a href="#Global_variables" class="section_anchor">¶</a></h1><p>You can specify formula here to manipulate the instantiated random variables: </p><pre class="prettyprint">a = 1.11111;<br>b = exp(3);<br>c = A + a + b;<br>d = sin(1.5*pi()) + c;<br>e = round(a, 0);<br>f = [0,1,2,3][A];<br>g = ["zero","one","two","three"][A];<br>distance = sqrt(a*a + b*b);</pre><p>The full list of mathematical function and operation is given in the documentation. </p><p>Note that evaluation of random variables is preformed before the evaluation 
of global variable, i.e. global variables include all random variables 
and you can use them in the main question text. </p><h1><a name="Per_answer_grading_result"></a>Per answer grading result<a href="#Per_answer_grading_result" class="section_anchor">¶</a></h1><p>Because there can have few subquestions, you can choose whether you want to show the grading result in the per answer basic. </p><p>The answer mark will be shown at the end of the answer box by default. </p><h1><a name="Per_answer_submit_button"></a>Per answer submit button<a href="#Per_answer_submit_button" class="section_anchor">¶</a></h1><p>This option only has effect in the adaptive mode. </p><p>Default
 behaviour of adaptive mode will have a button to submit all answers for
 the whole question. Because this questions type has subquestions, you 
can choose to submit one subquestion answer at a time. </p><h1><a name="Global_-_Trial_mark_sequence"></a>Global - Trial mark sequence<a href="#Global_-_Trial_mark_sequence" class="section_anchor">¶</a></h1><p>This option only has effect in the adaptive mode. Required. </p><p>Default
 behaviour of adaptive mode will have, say, 0.1, penalty for each wrong 
trial.  Instead, you can choose to have finite trial or infinite trials.
 For finite trial, say, you want to have three trials, the first one has
 100%, second one has 60% and third one has 20%, you can type: </p><pre class="prettyprint">1.00, 0.6, 0.2</pre><p>If you want to have infinite trial, each has 10% penalty, you can end the sequence by a comma: </p><pre class="prettyprint">1, 0.9,</pre><h1><a name="Global_-_Deduction_for_wrong_unit"></a>Global - Deduction for wrong unit<a href="#Global_-_Deduction_for_wrong_unit" class="section_anchor">¶</a></h1><p>This question type has a unit grading system. This option specify the mark you want to penalize the student for a wrong unit. </p><p>It takes value between 0 to 1. If it takes value 1, the unit and answer 
must be correct together in order to get mark.  On the other hand, if it
 takes value 0, students can get full mark if their answer is correct, 
no matter what random string they type after the answer. Therefore, it 
is recommended to use value 1 whenever the answer has no associated 
unit. </p><h1><a name="Global_-_Basic_conversion_rules"></a>Global - Basic conversion rules<a href="#Global_-_Basic_conversion_rules" class="section_anchor">¶</a></h1><p>This question type has a build-in unit conversion system and has basic conversion rules.  </p><p>The
 basic one is the "Common SI unit" rules that will convert standard unit
 such as unit for length, say, km, m, cm and mm. It has no effect if you
 do not use unit, or the correct answer unit has no SI unit. </p><hr><h1><a name="Default_answer_mark"></a>Default answer mark<a href="#Default_answer_mark" class="section_anchor">¶</a></h1><p>Required. </p><p>The
 mark for the answer of this subquestion, which should be a number 
greater than 0. The default mark of the whole question is the sum of the
 default mark of all subquestions. </p><p>If this answer mark field is left blank, this subquestion will be deleted when the question is successfully saved. </p><h1><a name="Local_variables"></a>Local variables<a href="#Local_variables" class="section_anchor">¶</a></h1><p>You can define and manipulate variables here similar to the global variables. </p><p>These
 local variables will be appended at the end of global variables and it 
can be used in the answer, post-answer variables, correctness and 
subquestion answer format. It is called local variables because it only 
has effect on this subquestion answer and cannot affect others. </p><h1><a name="Answer"></a>Answer<a href="#Answer" class="section_anchor">¶</a></h1><p>Required. </p><p>It is a number or a list of number (or a variable of these types defined before). e.g. </p><pre class="prettyprint">123<br>[1, 0, 0, 1]<br>a<br>[1, a, b]</pre><p>Note: the number of elements here defines the number of answer box of this subquestion.  </p><h1><a name="Grading_variables"></a>Grading variables<a href="#Grading_variables" class="section_anchor">¶</a></h1><p>It allows you to manipulate all local variables and the responses from the student. </p><p>See documentation for the advance usage. </p><h1><a name="Grading_criteria"></a>Grading criteria<a href="#Grading_criteria" class="section_anchor">¶</a></h1><p>Required. </p><p>You can choose either relative error and absolute error with error range. </p><p>For the precise definition of the relative error and absolute error when there is more than one answer box, see documentation. </p><h1><a name="Unit"></a>Unit<a href="#Unit" class="section_anchor">¶</a></h1><p>You can specify the unit here. </p><p>It is designed for SI unit, so an empty space represents the 'product' of different 'base unit' and <tt> ^ </tt> for the exponent. Also, <tt> / </tt> can be used for inverse exponent. </p><pre class="prettyprint">m<br>m^2<br>m s^(-1)<br>kg m/s<br>kW</pre><p>Students are required to use the same format. They may type the unit at the end of a long input box, e.g. </p><pre class="prettyprint">1 m<br>0.1 m^2<br>20 m s^(-1)<br>400 kg m/s<br>100 kW</pre><p>or two short input boxes for number and unit respectively, depends on the 
format you choose. Note that any permutation of the base unit are also 
accepted. </p><h1><a name="Other_rules"></a>Other rules<a href="#Other_rules" class="section_anchor">¶</a></h1><p>It defines the conversion rules for other accepted units. </p><p>See documentation for the advance usage. </p><h1><a name="Placeholder"></a>Placeholder<a href="#Placeholder" class="section_anchor">¶</a></h1><p>A
 placeholder is a used to identify the location in the main question 
text that will be replaced by the content in the subquestion answer 
format. The format of placeholder is a string of alphanumeric characters
 prefixed by '<strong>#</strong>'. Examples are </p><pre class="prettyprint">#1<br>#2<br>#3a<br>#3b<br>#A<br>#B</pre><p>If this field is left empty, the content in the subquestion answer format 
will be appended at the end of the main question text. </p><h1><a name="Subquestion_answer_format"></a>Subquestion answer format<a href="#Subquestion_answer_format" class="section_anchor">¶</a></h1><p>The location of answer boxes can be specified here. The placeholders that can be used are: </p><pre class="prettyprint">{_0}<br>{_1}<br>{_2}<br>...<br>{_u}</pre><p>The <tt> {_0}, {_1}, {_2} </tt> are the input boxes for numbers and <tt> {_u} </tt> is the input box for unit. You can place them at any location you want. </p><p>All missing placeholder are automatically appended at the end. A special case is that if <tt> {_0}, {_u} </tt> are specified consecutively <i>and</i> there is only one number in the answer, i.e. <tt> {_0}{_u} </tt>, they will be combined into a single long input answer box for both answer and unit. </p> </td> 
 </tr>
 </tbody></table>
 </div>
